Scripting of soap commands

ABSTRACT

A computer-implemented method processes a simple object access protocol (SOAP) command. The method includes interpreting an XML script to perform a function contained in the XML script, the XML script containing the SOAP command, parsing the SOAP command from the XML script, and passing the SOAP command to a SOAP interpreter for execution.

TECHNICAL FIELD

This invention relates generally to scripting simple object access protocol (SOAP) commands using extensible markup language (XML) and to providing the resulting XML script to a device for execution.

BACKGROUND

An apparatus may contain an embedded controller or agent software to monitor and control its operation. Any type of apparatus may have an embedded controller or agent including, but not limited to, home appliances, office equipment, medical devices, and industrial tools. Other examples include robots, blood analyzers, multifunction copiers, and air conditioners.

Embedded devices are often connected to an internal network, such as a local area network (LAN), with an interface to the Internet. Other devices on the internal network may communicate with an embedded device over the internal network. However, the embedded device is not generally addressable from the Internet. To address this problem, the embedded device may initiate communications with an addressable external device. That is, the embedded device may access the external device (e.g., a server) periodically to obtain necessary data.

SOAP is a standard for encoding function calls, such as remote procedure calls (RPCs), in XML. SOAP defines rules, i.e., a syntax, for encoding the function calls in XML. The body of a SOAP command is defined, at its start, by <SOAP-ENV:BODY> and, at its end, by </SOAP-ENV:BODY_(>). Code in between these two commands includes the function to be performed by the SOAP command. A SOAP command may include other data as well, such as header information.

SUMMARY

Heretofore, SOAP commands were only available as individual, discrete commands. This is impractical for device-initiated communication, particularly if the device is unaware of any timing issues relating to execution of the SOAP commands. The invention therefore scripts one or more SOAP commands in XML and provides the XML script to a device, such as an embedded controller, for execution. The XML script is executed by the embedded controller, much like a computer program, to control execution of the SOAP commands. For example, timing and sequence of execution of the SOAP commands may be specified in the XML script.

The invention also defines variables in the XML script, which may be passed to and from the SOAP commands. This facilitates the combination of SOAP commands in XML script and provides an advantage over the use of traditional SOAP commands, which are limited to passing “hard-coded” numerical values (i.e., non-variables).

In general, in one aspect, the invention is directed to a computer-implemented system for processing a simple object access protocol (SOAP) command. The system includes interpreting an XML script to perform a function contained in the XML script, the XML script containing the SOAP command, parsing the SOAP command from the XML script, and passing the SOAP command to a SOAP interpreter for execution. This aspect of the invention may include one or more of the following features.

Plural SOAP commands may be contained in the XML script. The plural SOAP commands may be passed to the SOAP interpreter. The plural SOAP commands may be executed in a sequence specified by the XML script. At least one of an argument and a return value may be received from the SOAP command following execution of the SOAP command. The argument may be stored as a variable in the XML script.

The XML script may declare a variable. A value of the variable may be passed as an argument to the SOAP command prior to executing the SOAP command. The function may be a conditional statement. The conditional statement may be an If-Then statement or an If-Then-Else statement. The function may be a control statement that affects a sequence of execution of the XML script and/or the SOAP command. The control statement may be a loop. The function may be an exception handler that affects a sequence of execution of the XML script and/or the SOAP command when an error condition exists. The function may be a statement that controls relative or absolute time to execute the SOAP command. Parsing may be performed by an XML interpreter and executing may be performed by the SOAP interpreter. The XML interpreter may pass the SOAP command to the SOAP interpreter and the SOAP interpreter may pass an output of the SOAP command to the XML interpreter.

In general, in another aspect, the invention is directed to a computer-implemented system for generating extensible markup language (XML) script that contains a simple object access protocol (SOAP) command. The system includes receiving code that defines a function and the SOAP command and translating the code to XML script that performs the function and contains the SOAP command. This aspect of the invention may include one or more of the following features.

The XML script may be provided to a device. The device may include a controller that executes the XML script. The code may contain plural SOAP commands and functions. The XML script may contain the plural SOAP commands and functions. The XML script may declare a variable. A value of the variable value may be passed as an argument to the SOAP command in the XML script.

The function may be a conditional statement. The conditional statement may be an If-Then statement or an If-Then-Else statement. The function may be a control statement that affects a sequence of execution of the XML script and/or the SOAP command. The control statement may be a loop. The function may be an exception handler that that affects a sequence of execution of the XML script and/or the SOAP command when an error condition exists. The function may be a statement that controls a relative or absolute time to execute the SOAP command.

Other features and advantages of the invention will become apparent from the following description, including the claims and drawings.

BRIEF DESCRIPTION OF THE DRAWINGS

FIG. 1 is a block diagram of a network containing a server and a device having an embedded controller;

FIG. 2 is a flowchart showing a process for translating human-readable code into XML script;

FIG. 3 is a flowchart showing a process by which the embedded controller retrieves XML script for the device from the server; and

FIG. 4 is a flowchart showing a process by which the embedded controller executes the XML script.

DESCRIPTION

FIG. 1 shows a network 10. Network 10 includes a device 11 containing an embedded controller 17. Device 11 is any type of apparatus or system having functions that are monitored and controlled by embedded controller 17.

Device 11 is connected to an internal network 12, such as a LAN. A router or modem 14 couples internal network 12 to an external network 15, such as the Internet/World Wide Web (Web). External network 15 runs TCP/IP (Transmission Control Protocol/Internet Protocol) or some other suitable protocol. Network connections are via Ethernet, telephone line, wireless, or other transmission media.

External network 15 contains a server 19, which is a computer or any other processing device. Server 19 communicates with embedded controller 17 over external network 15 and internal network 12. Embedded controller 17 has a local IP (Internet Protocol) address that can be resolved within internal network 12. However, this local IP address may not be recognizable by devices on external network 15, such as server 19. As such, server 19 may not be able to directly address device 11.

Embedded Controller

Embedded controller 17 runs software 20, which includes Web client application 21 and operating software 22. Web client application 21 includes a TCP/IP protocol stack that allows embedded controller 17 to communicate over external network 15. Device operating software 22 provides an interface between Web client application 21 and a database 24 in memory 25. Through device operating software 22, embedded controller 17 retrieves data stored in database 24 and stores data in database 24.

Software 20 also includes an XML interpreter 23 and a SOAP interpreter 26. XML interpreter 23 is a module that receives XML script, parses the script, and performs the functions identified by the script. As background, XML is a self-describing computer language, meaning that fields in XML code identify variables and their values in the XML code. For example, a “data” field is delineated by “<data>” to indicate the start of the field and “</data>” to indicate the end of the field. XML is used because it can be generated, parsed and understood relatively easily.

Among the functions in the XML script may be an instruction to identify a SOAP command and to pass the SOAP command to SOAP interpreter 26 for processing. An example of another function includes a statement that controls relative or absolute time to execute the SOAP command. SOAP interpreter 26 receives SOAP commands from XML interpreter 23 and executes those commands. Examples of SOAP commands that can be executed by the embedded controller or agent include setting the value of a variable, uploading or downloading a file, restarting the software, or any action specific to the apparatus.

Database 24 stores data, such as operational parameters, XML script, and identification information for the instance of device 11. What is meant by “instance” is the specific identity of device 11 as distinguished from other identical devices. The identification information stored in database 24 identifies the instance of device 11. This identification information may include data identifying the type of the device, a common (or “friendly”) name for the device, the manufacturer of the device, the model name of the device, the model number of the device, the serial number of the device, or a universal unique identifier (UUID) for the device.

The device type is the name of the device. The common name of the device is how the device is known in the vernacular, e.g., “television”. The manufacturer identifies the manufacturer of the device, e.g., Sony®. The model name identifies the particular model of the device, e.g., Wega®. The model number identifies the model number of the device, e.g., XBR400®. The serial number identifies the serial number of a particular instance of the device, e.g., 53266D. The UUID is a universal identifier for the instance of the device, e.g., 4A89EA70-73B4-11d4-80DF-0050DAB7BAC5. Of the data shown above, generally only the serial number and the UUID are unique to the instance of device 11.

The identification data stored in database 24 is used by embedded controller 17 to retrieve XML script specific to the instance of device 11 (or for a particular type of device 11) from server 19. A device-initiated process for retrieving the XML script is described below.

Server

Server 19 is a computer that runs an HTTP (Hypertext Transfer Protocol) Web server computer program. Server 19 includes a controller 27, such as a microprocessor, for executing software to perform the functions described below. To avoid confusion in terminology, the following reads as though those functions are performed by server 19, even though software in controller 27 of server 19 performs the functions.

Server 19 executes Web server software 29 to communicate over external network 15. Web server software 29 also hosts a Web page associated with device 11. The Web page (not shown) is displayed on computer 33 of a user, such as the owner of device 11, who may select some actions to be sent to the device. For example, a remote operator may want to update three operational variables, which requires three SOAP commands. These three SOAP commands are wrapped in an XML script that executes the commands as a single operation. The XML script, along with any input updated operational parameters (if desired) are transmitted to Web server software 29 over external network 15. Web server software 29 stores the XML script in database 30 of memory 31. An example of a process for updating operational parameters is described in U.S. patent application Ser. No. 09/667,737, filed Sep. 22, 2000, the contents of which are incorporated into this application by reference as if set forth herein in full.

Web server software 29 stores and retrieves XML script from database 30 using application logic 32. Application logic 32 is software for accessing database 30 using Java servlets and a JDBC (Java Data Base Connectivity) database driver. The XML script can be stored in database 30 individually or as part of a configuration file for an instance of device 11.

Computer

Computer 33 is personal computer (PC) or other machine that includes a processor 36, a memory 37, and a storage medium 38 (see view 55). Storage medium 38 stores computer programs 39, which are executed by processor 36 out of memory 37. Computer programs 39 include a Web client application 43 containing a TCP/IP protocol stack for communicating over the Internet, a Web browser 44 such as Microsoft® Internet Explorer® for accessing Web pages, an operating system (OS) 45 such as Microsoft® Windows98®, and executable instructions 46 for implementing process 50, which is shown in FIG. 2.

Process 50 generates XML script containing one or more SOAP commands from user-generated code provided to computer 33. The code may be input by the user via a graphical user interface (GUI) (not shown), for example, or it may be retrieved from a storage medium or over network 15.

The code has a syntax that can be understood and interpreted by instructions 46. For example, the code may be a commonly-understood computer language, such as BASIC or “C”, or a form of pseudo-code specific to the invention. The code defines functions, such as conditional statements (e.g., If-Then or If-Then-Else statements), control statements (e.g., do While or do Until loops), or exception handlers, meaning fail-safe mechanisms that are triggered in the code in the event that an instruction in the code fails. The functions affect the sequence of execution of the resulting XML code and/or SOAP commands.

An example of user-generated C/C++ code is set forth below:

  int local = 8; int total = 0; while ( total < 10 ) {  total = SomeFunction(total);  AnotherFunction(local); } This code initializes integer variables “local” and “total” to values of “8” and “0” respectively. The code includes a “While” loop, meaning that the loop between the brackets “{ }” is continually executed while the value of total is less than “10”, whereafter processing within the loop is discontinued. Within the loop, the value of “total” is set equal to the result of a SOAP command called “SomeFunction” processing the previous value of “total” and another SOAP command called “AnotherFunction” processing “local”.

Process 50 receives (201) code, such as that shown above, that defines one or more functions (e.g., a “While” loop) and one or more SOAP commands (e.g., “SomeFunction” and “AnotherFunction”). Process 50 translates (202) the code to XML script that, when interpreted, performs the functions and contains the SOAP commands. To perform the translation, process 50 may compile the code, interpret the functions in the compiled code, and generate appropriate XML script from the compiled code. An appropriate compiler may be included within instructions 46 for this purpose. The format of the SOAP commands may be static and known to the compiler, or the format may be determined dynamically from a WSDL (Web Services Description Language) document. WSDL is a standard for describing SOAP commands. WSDL is itself an XML document that can be interpreted automatically. WSDL defines the set of functions available and the format of each of the SOAP commands.

WSDL usually describes the functionality for a particular device or Web service. By reading WSDL, a program can display functions to a user, then create SOAP command(s) for the function(s) selected by the user. By way of example, there may be one thousand devices, all with individual settings, and it is desired to set all of the devices to 6% lower power usage. Using traditional SOAP commands, the server must be able to address each device, obtain each device's current setting, calculate 94% of its value, then write that new value back to each device, all through issuing individual SOAP commands. Using a SOAP script, the same script can be sent to all of the devices because the variable is evaluated locally at each device. As the population of monitored devices grows, this kind of distributed processing becomes more useful.

Continuing with the example set forth above, process 50 translates (202) the code into the following XML script:

  <Root>  <Variables>   <local type=″integer″>8</local>   <total type=″integer″>0</total>  </Variables>  <Script>   <While condition=″total < 10″>    <SOAP-ENV:Body>     <SomeFunction>     <Count>total</Count>     </SomeFunction>    </SOAP-ENV:Body>    <Return variable=″total″/>    <SOAP-ENV:Body>     <AnotherFunction>      <Input>local</Input>     </AnotherFunction>    </SOAP-ENV:Body>   </While>  </Script> </Root> The XML script contains the same functions and SOAP commands as the original C/C++ code input by the user. For example, the “While” loop is expressed as

<While condition=“total <10”> and </While>

and the SOAP commands are expressed as

   <SOAP-ENV:Body>   <SomeFunction>   <Count>total</Count>   </SomeFunction>  </SOAP-ENV:Body> and  <SOAP-ENV:Body>   <AnotherFunction>   <Input>local</Input>   </AnotherFunction> </SOAP-ENV:Body> The expression “<Return variable=” total“/>” returns the value of the variable “total” to the XML script. Thus, the output of the SOAP command may be passed back to the XML script as an argument in the SOAP command and used as a variable in the XML script. Also, the XML script may be written so that a variable, such as “total”, is passed as an argument to a SOAP command.

An example of XML script containing a conditional “IF” statement is set forth in Appendix A attached hereto. An example of XML script containing an exception handler is set forth in Appendix B attached hereto.

After the code has been translated (202) to XML script, process 50 provides (203) the XML script to server 19 over network 15. Process 50 may send the XML script to server 19 through a Web interface, along with identification information that specifies the instance of device 11 for which the XML script is intended. Web server software 29 on server 19 receives the XML script over network 15 and application logic 32 stores the XML script in database 30, along with its associated identification information.

Device-Initiated Retrieval of the XML Script

Embedded controller 17 executes software 20 to retrieve the XML script intended for device 11 from remote server 19. In response, server 19 executes software 34 to send the XML script to embedded controller 17. FIG. 3 shows these processes in detail. The left half of FIG. 3, titled “Embedded Controller” shows process 40 performed by embedded controller 17, and the right half of FIG. 3, titled, “Server”, shows process 41 performed by server 19.

Process 40 generates and sends (301) a command to server 19. The command, or a modified version thereof, is sent by embedded controller 17 to server 19 periodically. It is through this command that embedded controller 17 polls server 19 to determine if there is any new/updated XML script for device 11 on server 19.

The command includes XML data identifying device 11. The data identifies the specific instance of device 11 and may include a device type field and one or both of a device serial number field and a device UUID. The command may also include a common name field, a manufacturer name field, a model name field, and a model number field, which specify the information set forth above for the device.

The command may be either an HTTP GET command or an HTTP post command. The data included in those commands is similar, with the difference being that the HTTP GET command retrieves a document, such as a file containing the XML script, and the HTTP POST command retrieves information, such as the XML script itself.

Process 41 (in server 19) receives (302) the HTTP command from embedded controller 17. Process 41 identifies the command as either a POST or GET command based on a header, such as “POST/CONTROL HTTP/1.1” (for a POST command), in the command. Process 41 uses an XML parser to parse (303) the various identifying fields, such as device type, serial number, and UUID, from the command.

Process 41 identifies (304) the instance of device 11 based on the information parsed from the command. That is, process 41 uses the device type, serial number, and UUID field information to identify the instance of device 11.

If the Command is a POST Command

The identification information from the command, in particular the device serial number and/or UUID, is used to search through database 30 for XML script specific to device 11. Once the appropriate XML script has been identified (304), process 41 retrieves (305) that XML script from database 30 using application logic 32. Process 41 determines if the XML script has been updated since it was last retrieved. This may be done by examining a revision number or date included in a header associated with the XML script. If the XML script has been updated, process 41 adds the updated XML script to the reply portion of POST command and sends (306) the POST command, with the updated XML script, back to embedded controller 17.

If the Command is a GET Command

As was the case above with the POST command, the identification information from the command is used to search through database 30 for XML script for the specific instance of device 11. In particular, the device serial number and/or UUID are used to retrieve (305) a configuration file that is specific to device 11. The configuration file contains the XML script for device 11. Process 41 sends (306) the configuration file to embedded controller 17.

Process 40 receives (307) the XML script containing one or more SOAP commands from server 19 in response to the HTTP command. Process 40 (in particular Web client application 21 in device 11) provides the XML script to XML interpreter 23, where the XML script is executed.

Referring to FIG. 4, a process 52 is shown for executing the XML script in embedded controller 17. Process 52 is implemented by executable instructions in XML interpreter 23 and SOAP interpreter 26.

XML interpreter 23 interprets (401) the XML script to perform the functions contained therein. For example, if there are any conditional statements, control statements, or exception handlers defined by the XML script, XML interpreter performs those functions on the appropriate commands and variables contained in the XML script.

During processing, XML interpreter 23 parses (402) the XML script to identify any SOAP commands contained in the XML script. Identified SOAP commands are passed to SOAP interpreter 26, which executes (403) the SOAP commands. Results of the SOAP commands may be passed back to the XML interpreter 23 for further processing. Likewise, variables may be passed from the XML script to the SOAP commands.

Using XML script in this manner, embedded controller 17 is able to execute multiple SOAP commands in response to a single device-initiated query. Thus, device 11 can perform reconfiguration operations or the like using multiple SOAP commands without maintaining communication with an external device, such as server 19, during the reconfiguration process. The XML script can specify (future) times at which the SOAP commands are to be executed, thus providing the device with further control over its own operation. SOAP interpreter 26 implements the SOAP standard to interpret and execute function calls. As more devices and software systems have support for SOAP, device 11 will be able to execute a script that controls multiple devices by calling their SOAP services.

Architecture

Processes 40, 41, 50 and 52 are not limited to use with the hardware/software configuration of FIG. 1; they may find applicability in any computing or processing environment. Processes 40, 41, 50 and 52 may be implemented in hardware (e.g., an ASIC {Application-Specific Integrated Circuit} and/or an FPGA {Field Programmable Gate Array}), software, or a combination of hardware and software.

Processes 40, 41, 50 and 52 may be implemented using one or more computer programs executing on programmable computers that each includes a processor, a storage medium readable by the processor (including volatile and non-volatile memory and/or storage elements), at least one input device, and one or more output devices.

Each such program may be implemented in a high level procedural or object-oriented programming language to communicate with a computer system. Also, the programs can be implemented in assembly or machine language. The language may be a compiled or an interpreted language.

Each computer program may be stored on a storage medium or device (e.g., CD-ROM, hard disk, or magnetic diskette) that is readable by a general or special purpose programmable computer for configuring and operating the computer when the storage medium or device is read by the computer to perform processes 40, 41, 50 and 52.

Processes 40, 41, 50 and 52 may also be implemented as an article of manufacture, such as one or more machine-readable storage media (e.g., compact or floppy disc), each configured with a computer program, where, upon execution, instructions in the computer program cause a machine (e.g., a computer) to operate in accordance with one or more of processes 40, 41, 50 and 52.

The invention is not limited to use with the protocols and standards described above. For example, Web server may use Java Servlets, ASP (Active Server Pages), ISAPI (Internet Server Application Programming Interface), or .NET interfaces to communicate with application logic 32. The HTTP commands sent by embedded controller 17 and/or server 19 are not limited to HTTP GET and POST commands. Any commands and/or requests for requesting and receiving data may be used.

The invention is not limited to the protocols and architecture described with respect to FIG. 1. Similarly, the invention is not limited to device-initiated transfers of the XML script. For example, computer 33 may transmit the XML script directly to embedded controller 17 (rather than by way of server 19) via e-mail, file transfer protocol (FTP), message queues, or any other type of data transfer mechanism. These other transfer protocols may also be used with device-initiated transfers. Server 19 may generate the XML script and transmit it directly to controller 17. The XML script may be used on any machine, and is not limited to use with embedded controllers. RPCs other than SOAP calls may be scripted using XML and the resulting XML script may be processed in the manner described herein. SOAP commands other than those described herein may be used. The processes described herein may be implemented using circuitry such as programmable logic, logic gates, a processor, and/or a memory.

Other embodiments not specifically described herein are also within the scope of the following claims. 

What is claimed is:
 1. A computer-implemented method for processing a simple object access protocol (SOAP) command, comprising: interpreting an XML script to perform a function contained in the XML script, the XML script containing the SOAP command; parsing the SOAP command from the XML script; and passing the SOAP command to a SOAP interpreter for execution.
 2. The method of claim 1, wherein plural SOAP commands are contained in the XML script; and the method further comprises passing the plural SOAP commands to the SOAP interpreter.
 3. The method of claim 2, wherein the plural SOAP commands are executed in a sequence specified by the XML script.
 4. The method of claim 1, further comprising: receiving at least one of an argument and a return value from the SOAP command following execution of the SOAP command; and storing the argument as a variable in the XML script.
 5. The method of claim 1, wherein: the XML script declares a variable; and a value of the variable is passed as an argument to the SOAP command prior to executing the SOAP command.
 6. The method of claim 1, wherein the function comprises a conditional statement.
 7. The method of claim 6, wherein the conditional statement comprises an If-Then statement or an If-Then-Else statement.
 8. The method of claim 1, wherein the function comprises a control statement that affects a sequence of execution of the XML script and/or the SOAP command.
 9. The method of claim 8, wherein the control statement comprises a loop.
 10. The method of claim 1, wherein the function comprises an exception handler that affects a sequence of execution of the XML script and/or the SOAP command when an error condition exists.
 11. The method of claim 1, wherein the function comprises a statement that controls relative or absolute time to execute the SOAP command.
 12. The method of claim 1, wherein parsing is performed by an XML interpreter and executing is performed by the SOAP interpreter, the XML interpreter passing the SOAP command to the SOAP interpreter and the SOAP interpreter passing an output of the SOAP command to the XML interpreter.
 13. A computer-implemented method for generating extensible markup language (XML) script that contains a simple object access protocol (SOAP) command, comprising: receiving code that defines a function and the SOAP command; and translating the code to XML script that performs the function and contains the SOAP command.
 14. The method of claim 13, further comprising providing the XML script to a device.
 15. The method of claim 14, wherein the device comprises a controller that executes the XML script.
 16. The method of claim 13, wherein the code contains plural SOAP commands and functions, and the XML script contains the plural SOAP commands and functions.
 17. The method of claim 13, wherein: the XML script declares a variable; and a value of the variable value is passed as an argument to the SOAP command in the XML script.
 18. The method of claim 13, wherein the function comprises a conditional statement.
 19. The method of claim 18, wherein the conditional statement comprises an If-Then statement or an If-Then-Else statement.
 20. The method of claim 13, wherein the function comprises a control statement that affects a sequence of 5 execution of the XML script and/or the SOAP command. 21-71. (canceled) 